<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
  <meta name="copyright"
 content="Copyright (c) IBM Corporation and others 2009, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
  <meta http-equiv="Content-Type"
 content="text/html; charset=ISO-8859-1">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
  <title>Content categorization</title>
</head>
<body>
<h1>Content categorization</h1>
<p>
By default, the p2 Install Software Dialog groups all the installable units by category.  If an installable unit is not
categorized, it will not be displayed in the user interface. 
</p>

<img src="images/no_category.png" alt="Picture showing the 'Install Software' dialog without categorized items">

<p>
There are currently two supported methods for categorizing content.
</p>
<ol>
<li><a href="#category_def">A category definition file</a></li>
<li><a href="#p2_inf">A p2.inf file</a></li>
</ol>

<h2><a name="category_def">Category Definition File</a></h2>
<p>
A category definition file is an XML file that describes which categories a feature should be listed in.  
The category definition file can be edited using the 
<a href="../../org.eclipse.pde.doc.user/guide/tools/editors/category_editor/definition_page.htm">Category Definition Editor</a>. 
The category definition can be specified when 
<a href="../../org.eclipse.pde.doc.user/guide/tools/export_wizards/export_features.htm">exporting a feature</a>, 
<a href="../../org.eclipse.pde.doc.user/tasks/pde_p2_builds.htm">building using PDE Build</a>, 
or injected into a repository using the 
<a href="p2_publisher.html#category_publisher">category publisher</a>.
</p>

<h2><a name="p2_inf">The p2.inf File</a></h2>
<p>
The p2.inf file is a properties file that can be used to customize capabilites, properties, and instructions. Information
about this provisional file is available in the section 
<a href="p2_customizing_metadata.html">Customizing p2 metadata</a>.

</p>
</body>
</html>
